home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Tech Arsenal 1
/
Tech Arsenal (Arsenal Computer).ISO
/
tek-07
/
f-gate.exe
/
README.DOC
< prev
Wrap
Text File
|
1993-06-12
|
27KB
|
633 lines
FLASH-Gate(TM). Copyright (C) 1993 Frango KB Page 1
README.DOC for FLASH-Gate(TM) - June 12, 1993
===============================================
Copyright (C) 1993 by Frango KB. All rights reserved.
Trademarks and acknowledgments:
LANtastic is a registered trademark of Artisoft Inc.
Futurus TEAM is a trademark of Futurus Corporation.
MHS was originally developed by Action Technologies.
cc:Mail is a trademark of cc:Mail, Inc., a wholly-owned subsidiary of
Lotus Development Corporation.
WP Office is a trademark of Word Perfect Corporation.
FLASH-Gate is a trademark of Frango KB.
NICK Systems
9005 Exposition Blvd
Los Angeles, CA 90034
U.S.A.
Phone: (310)841-2901
Fax: (310)785-1050
MHS: SALES@COLORSHP or TECH@COLORSHP via NHUB or direct
(310)841-2074
LICENSES, WARRANTIES AND DISCLAIMERS
====================================
I. The trial version of FLASH-Gate(TM) may be distributed via
electronic mail or electronic BBS's and information services as
long as the contents of this archive have not been modified. The
trial version of the software may be included with other packages
or publications only with the permission of Frango.
II. The registered version of FLASH-Gate(TM) may not be redistributed,
and the normal rules of commercial copyrighted software apply.
III. NO WARRANTY. ANY USE BY YOU OF THE SOFTWARE IS AT YOUR OWN RISK.
THE SOFTWARE IS PROVIDED FOR USE AS IS WITHOUT WARRANTY OF ANY
KIND. FRANGO AND NICK SYSTEMS DISCLAIM ALL WARRANTIES OF ANY KIND,
EITHER EXPRESS OR IMPLIED, INCLUDING, WITHOUT LIMITATION, IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
FLASH-Gate(TM) Trial Version
============================
The trial version works exactly the same way as the retail package,
except that the trail program will expire when the trial period is over.
You can the acquire a retail package from NICK Systems and install it
without loosing your existing data.
FLASH-Gate(TM). Copyright (C) 1993 Frango KB Page 2
INTRODUCTION
FLASH-Gate(TM) is an MHS Gateway that connects LANtastic(R) Mail to MHS.
It allows you to send messages between LANtastic(R) Mail programs (like
LANtastic's Mail and rMail) and MHS E-mail programs (like Futurus
TEAM(TM)). The gateway also lets you connect LANtastic(R) Mail servers
for message interchange with each other using MHS. It also opens up the
possibility to communicate with other platforms (cc:Mail, WP Office
etc.) from LANtastic(R) Mail using the proper MHS gateways.
==> Features
* Send message from MHS to LANtastic(R) Mail.
* Send message from LANtastic(R) Mail to MHS.
* Send message from LANtastic(R) Mail to other LANtastic(R) Mail
server/location (remote or local) via MHS.
* Supports sending of binary files from LANtastic(R) Mail to MHS as
MHS attachments.
* MHS messages with file attachments sent to LANtastic(R) will be
broken up to several LANtastic(R) Mail messages, one for the MHS
body part, and one for each MHS attachment.
* MHS to LANtastic(R) Mail addressing is done via a standard MHS
address with an extended part.
* LANtastic(R) Mail to MHS addressing is done either via an address
translation table, or the MHS address can be taken from the first
line of the LANtastic(R) message.
* The LANtastic(R) address (to MHS) shortname/alias can be selected
from the LANtastic(R) user list. The shortname/alias in the
translation table can be a group and consist of any number and type
of MHS addresses.
==> System requirements
FLASH-Gate(TM) requires MHS 1.5 and LANtastic(R) 3.X or later.
FLASH-Gate(TM). Copyright (C) 1993 Frango KB Page 3
ADDRESSING AND CONVERSIONS
Parts of the following chapter are a bit technical in nature, and are
more for your reference. The important parts must be read and understood
are the sections "Addressing a LANtastic(R) Mail user in MHS" and
"Addressing an MHS user in LANtastic(R) Mail". Before you continue
reading, make sure you know how to address messages in LANtastic(R) Mail
and MHS. The following chapter requires basic knowledge of MHS and
LANtastic(R) Mail.
==> Sending E-mail from MHS to LANtastic(R) Mail
=> Addressing a LANtastic(R) Mail user in MHS
The addressing of a LANtastic(R) Mail user is done via the MHS extended
address part. The address is of the type:
LANTMAIL @HOST {LANtastic: S=SERVER; U=USER;}
Where:
* "LANTMAIL" is the name of the MHS gateway that you selected during
installation. (Default name is LANTMAIL).
* "HOST" is the name of your MHS host/workgroup.
* "SERVER" is the name of the LANtastic(R) server that the user
resides on.
* "USER" is the LANtastic(R) username.
A typical address might look like:
LANTMAIL @FRANGO {LANtastic: S=SERVER1; U=MIKE;}
How you enter an address depends on your MHS E-mail package. Please
consult your E-mail documentation on how to do this.
=> Invalid address(es)
If the LANtastic(R) Mail address in the MHS message was invalid, the
sender of the MHS message will get a non-delivery report stating the
problem. However, the sender is responsible that the LANtastic(R)
username is correct, just as when sending a message from LANtastic(R)
Mail.
=> Conversions MHS =>> LANtastic(R) Mail
All visible MHS headers (like To, From, Date, Subject, etc.) will be
copied to the LANtastic(R) message together with the MHS message body.
The MHS "Subject:" header will also be truncated to 47 characters and
put in the LANtastic(R) Mail "Comment" field.
MHS Messages with attachments will be split up into several LANtastic(R)
Mail messages. The MHS headers and body will be copied to the first
LANtastic(R) message, then there will be one additional LANtastic(R)
message for each MHS attachment. The LANtastic(R) messages that are
converted from MHS attachments will have the Voice mail flag set to
FLASH-Gate(TM). Copyright (C) 1993 Frango KB Page 4
distinguish them from text files.
==> Sending E-mail from LANtastic(R) Mail to MHS
=> Addressing an MHS user in LANtastic(R) Mail
Since there is no way of entering a more complicated address in
LANtastic(R) Mail, addresses must be translated via a translation table.
This translation table contains shortnames/aliases (following
LANtastic(R) username conventions) and their corresponding full MHS
addresses.
The translation table file is named "LANTMAIL.TAB" and is located in the
%MAIL%\GATES\LANTMAIL\PUBLIC (or %MV%\MHS\MAIL\GATES\LANTMAIL\PUBLIC)
subdirectory. For example if you have installed MHS on the drive "F:"
and kept the default FLASH-Gate(TM) gateway name "LANTMAIL", the full
path of the file is:
"F:\MHS\MAIL\GATES\LANTMAIL\PUBLIC\LANTMAIL.TAB"
The translation table (LANTMAIL.TAB) is a standard ASCII file and
consists of one line for every alias/address entry. Each line/entry has
the following format:
ALIAS,TYPE,MHS ADDRESS
Where:
* "ALIAS" is the alias/shortname to be used when sending a
LANtastic(R) message. It follows the LANtastic(R) username
conventions (max 16 characters), and can be picked from the
LANtastic(R) user list if it has been entered as a username in
NET_MGR. But the alias does not necessarily have to be entered as a
LANtastic(R) username as long as it is defined in LANTMAIL.TAB. The
alias must start with the characters "MHS:".
* "TYPE" is the address type. 'N' stands for "normal" addresses,
meaning the MHS address(es) will be picked from "MHS ADDRESS". 'O'
means it is a one-off address, and the MHS address(es) will be
picked up from the first line(s) of the LANtastic(R) message.
* "MHS ADDRESS" is the MHS address(es) that should be used in the
message instead of the alias. This can be just one address or a
group with any number of addresses, as long as the total line
length is less than 512 characters.
Example "LANTMAIL.TAB":
******************************************************************
MHS:ONE-OFF,O,The address field is not used for ONE-OFF
MHS:FRANGO-CJ,N,CJ @FRANGO
MHS:FRANGO-MIKE,N,LANTMAIL @FRANGO {LANtastic: S=SERVER1; U=MIKE;}
MHS:SALESGROUP,N,CJ @FRANGO, SALES @NICK, SALES @COLORSHP
******************************************************************
For example, if you pick/type the address "MHS:FRANGO-CJ" in the "Enter
User to Receive Mail" field when sending a LANtastic(R) message, the
gateway will convert it to the corresponding MHS address, "CJ@FRANGO".
If you instead would want the address(es) to be picked from the message
FLASH-Gate(TM). Copyright (C) 1993 Frango KB Page 5
itself (for example if the destination user hasn't been entered in the
translation table), enter the address(es) as the first line(s) of the
LANtastic(R) message. This address follows the MHS standard address
format. Addresses are separated with commas (",") and can be split up on
several lines by having the continuation lines begin with a space or a
tab.
Example LANtastic(R) message with "ONE-OFF address:
******************************************************************
CJ @FRANGO, SALES @NICK,
TECH @NICK
This is the first line of the LANtastic message itself.
Here comes the second line...
******************************************************************
By selecting/typing "MHS:ONE-OFF" in the "Enter User to Receive Mail"
field when sending this LANtastic(R) message, the message will be
delivered to the three recipients "CJ@FRANGO", "SALES@NICK" and
"TECH@NICK".
=> Invalid address(es)
If the "ALIAS" you selected is not defined in the translation table, the
message will remain in your "OUTgoing Mail" box and never be picked up.
When the message disappears from your "OUTgoing Mail" box, you know that
the message has been sent off by FLASH-Gate(TM). To be sure that your
messages are successfully sent, check your "OUTgoing Mail" box
periodically.
=> Conversions LANtastic(R) Mail =>> MHS
The MHS headers are constructed from the LANtastic(R) message in the
following way:
MHS
header Construction
------ ------------
To: will be taken from the "MHS ADDRESS" in the translation table
or from the first line(s) of the message if it is a "one-off"
address.
From: will be constructed as your MHS address. The recipient can
just reply to your message using this address and the reply
will be delivered to you.
Example generated "From:" address:
LANTMAIL @FRANGO {LANtastic: S=SERVER1; U=MIKE;}
Date: will be taken from the date/time the LANtastic(R) message was
sent.
Subject: will be copied from the LANtastic(R) message's "Comment"
field.
=> Sending LANtastic(R) Mail binary or voice files
FLASH-Gate(TM). Copyright (C) 1993 Frango KB Page 6
If the LANtastic(R) message you are sending is a binary file, you should
select "Send Voice file". This will tell the gateway to convert the
LANtastic(R) message body to an MHS attachment. If you send your binary
files as text files instead of voice files, the recipient will receive a
garbage message.
FLASH-Gate(TM). Copyright (C) 1993 Frango KB Page 7
INSTALLATION
Now that you know how FLASH-Gate(TM) works, it is time to install it.
Follow the steps below to complete the installation.
==> Gateway installation
Take your MHS server off-line (stop the MHS program). Go the MHS
server/host. (You must have a working MHS installation before you can
install FLASH-Gate(TM)). Make sure the currently logged-in user has
write/create directory rights/privileges to the MHS directory. The MHS
server/host login must also have SuperMail (M) privilege on all the
LANtastic(R) servers that it will pick up/deliver mail to/from. (Set
SuperMail privilege by starting NET_MGR, select "Individual Account
Management", select the MHS user/login name, move to the "Privileges"
field and press "M".)
Insert the FLASH-Gate(TM) diskette in the diskette drive. Type:
"A:INSTALL" (or "B:INSTALL") and press ENTER
Follow the onscreen instructions. When the installation is complete, you
have installed the FLASH-Gate(TM) MHS gateway.
==> Address translation table LANTMAIL.TAB
As explained in the previous chapters, you must enter addresses in the
translation table LANTMAIL.TAB before you can send any messages to/via
MHS from LANtastic(R) Mail. You can edit the table file with any kind of
text editor or word processor that can read and write standard ASCII
files. The full path of the table is:
\MHS\MAIL\GATES\LANTMAIL\PUBLIC\LANTMAIL.TAB
Enter the addresses as described in section "Addressing an MHS user in
LANtastic(R) Mail". Make sure that all the aliases start with the
characters "MHS:".
==> Entering "aliases" as LANtastic(R) usernames
If you desire, it is possible to pick the remote (MHS) addresses from
the LANtastic(R) user list when you send LANtastic(R) Mail messages. To
be able to this, the aliases/shortnames for the addresses must be
entered as LANtastic(R) users in NET_MGR.
However, it is not necessary to do this. LANtastic(R) Mail allows you to
enter addresses/usernames that are not defined on the server, and
FLASH-Gate(TM) will pick up the message anyway, as long as the
alias/address is defined in LANTMAIL.TAB.
To enter the aliases/addresses in the LANtastic(R) user list, start
NET_MGR, select "Individual Account Management" and enter the
aliases/shortnames. Make sure you spell the alias exactly the same way
as in LANTMAIL.TAB. Also set the "Number of Concurrent Logins" to 0 so
that noone can login using these usernames.
FLASH-Gate(TM). Copyright (C) 1993 Frango KB Page 8
That does it! Now you are ready to try it out!
Good luck and Have fun!
FLASH-Gate(TM). Copyright (C) 1993 Frango KB Page 9
TROUBLESHOOTING
If you are getting error messages, please check them against the proper
list below and follow the recommendations. If nothing helps, send a
message to NICK Systems technical support. Technical support is
preferably reached via MHS as "TECH @COLORSHP" via NHUB or direct
310-841-2074. Please supply a detailed description together with your
FLASH-Gate(TM) version and serial number and also your MHS version.
Thanks for your patience!
==> User and addressing errors
=> Non-delivery of LANtastic(R) Mail message
My LANtastic(R) Mail message never gets picked up by the gateway. What
is wrong?
* First, check that your MHS is running and has gone through a full
cycle.
* Secondly, verify that the MHS host/server is logged in to the
LANtastic(R) server the message was sent on.
* Third, check that your address is correct. The "ALIAS" that you
enter in the "Enter User to Receive Mail" field must be entered in
the LANTMAIL.TAB file and it also has to start with the letters
"MHS:".
* If this did not help, then finally check the INPOST.ERR file (as
described in the section "Gateway error messages") which will hold
an error message if the gateway failed.
=> Non-delivery of MHS message
When I try to send a message to a LANtastic(R) user via MHS and
FLASH-Gate(TM) I get the following message back:
******************************************************************
To: CJ @FRANGO (Carl-Johan L fstedt)
From: LANTMAIL @FRANGO
Subject: Non-delivery report
Message-id: DB8C132C8133A0E0
Via-host: FRANGO.FRANGO
Date: 7-Jun-93 18:45:31
The message you sent to:
LANTMAIL@FRANGO {LANtastic: S=NONEXISTENT; U=CJ;}
on 7-Jun-93 18:44 could not be delivered to:
LANTMAIL @ FRANGO {LANtastic: S=NONEXISTENT; U=CJ;}
Reason:
Cannot access mail resource on LANtastic server in address.
Please verify that the address is correct.
FLASH-Gate(TM). Copyright (C) 1993 Frango KB Page 10
Original message:
******************************************************
Date: 7-Jun-93 18:44
From: CJ @FRANGO (Carl-Johan L fstedt)
To: LANTMAIL@FRANGO {LANtastic: S=NONEXISTENT; U=CJ;}
Subject: This is a test message
Application-name: MHS
Message-id: 778C132C0133A0E0
This is a test message from MHS E-mail to LANtastic Mail.
******************************************************************
* This means that the message you sent didn't reach its destination
because the gateway couldn't access the mail device on server
"NONEXISTENT". It can be one of the following reasons for this:
- the LANtastic(R) server "NONEXISTENT" does not exist
- the MHS server/host is not logged in on "NONEXISTENT"
- "NONEXISTENT" does not have a mail device (@MAIL)
- the queue/spool area on "NONEXISTENT" is damaged or the disk
is full!
You can also get a non-delivery message for other reasons:
******************************************************************
The message you sent to:
LANTMAIL@FRANGO {LANastic: S=SERVER1; U=CJ;}
on 7-Jun-93 18:44 could not be delivered to:
LANTMAIL @ FRANGO {LANastic: S=SERVER1; U=CJ;}
Reason:
Invalid LANtastic address in above extended address.
******************************************************************
* This means that there was something wrong in the MHS extended
address part. Please refer to section "Addressing a LANtastic(R)
Mail user in MHS". The problem in this case was that "LANTASTIC"
was misspelled as "LANastic".
Another non-delivery message can have this reason:
******************************************************************
The message you sent to:
LANTMAIL@FRANGO
on 7-Jun-93 18:44 could not be delivered to:
LANTMAIL @ FRANGO {}
Reason:
Invalid address. Extended address part missing.
******************************************************************
FLASH-Gate(TM). Copyright (C) 1993 Frango KB Page 11
* This means that the MHS extended address part was completely
missing. The address needs an extended part as described in section
"Addressing a LANtastic(R) Mail user in MHS".
==> Installation error messages
Cannot create gateway (errorcode CODE). Please run manual installation.
* The installation failed. Contact NICK Systems.
Cannot start MHSUSER program. Please verify your MHS installation.
* The installation program cannot find the MHSUSER program. Make sure
that your MV variable is correctly set. (For example, if you have
installed MHS on "F:\" you should have the "SET MV=F:\" command on
the workstation).
Can't open INSTALL.INF on this drive! Select another drive.
* The installation program cannot find the INSTALL.INF file. Your
installation disk is incomplete. Contact NICK Systems.
Couldn't add gateway. Try once to select another name.
* Gateway name already used as a hostname in MHS. Try using another
name.
Invalid INSTALL.INF
* Damaged file. Your installation disk is damaged. Contact NICK
Systems.
Invalid installation disk: "FILE" is missing on "DISK"
* Your installation disk is incomplete. Contact NICK Systems.
MHS is currently running. Please stop the MHS program on the MHS server.
* The MHS program is running. The program must be stopped before the
installation can continue.
MHS requires (administrators) password. Please supply.
* Your MHS has been setup with an administrators password. You need
to supply that password to continue the installation.
MV environment variable not defined
* The MV variable has not been set at the workstation. Set MV to
point to your MHS installation. (For example, if you have installed
MHS on "F:\" you should have the "SET MV=F:\" command on the
workstation).
==> Gateway error messages
When the gateway encounters an error, the error message gets written to
the INPOST.ERR file located in the gateways PUBLIC directory.
(\MHS\MAIL\GATES\LANTMAIL\PUBLIC\INPOST.ERR)
Cannot close mail device (LANtasticMail:Send)
* The disk (that the LANtastic(R) queue/spool area resides on) is
probably full.
Cannot close MHS file (Message:Write)
* The disk (that MHS resides on) is probably full.
FLASH-Gate(TM). Copyright (C) 1993 Frango KB Page 12
Cannot delete message from [USERNAME] (Inpost:LANtasticToMHS)
* Only the sender or SuperMail user can delete this message. The MHS
server/host needs SuperMail privileges. See the "Installation"
section.
Cannot open body/text file (LANtasticMail:Read)
* Cannot access queue entry/spooled file. The LANtastic(R)
queue/spool area may be corrupt.
Cannot open mail device on Server [SERVER] (LANtasticMail:Send)
* Either the MHS Server/host is not logged in on "SERVER", or
"SERVER" has no mail device.
Cannot open MHS file (Message:Write)
* The disk (that MHS resides on) is probably full.
Cannot open source file [FILENAME] (LANtasticMail:Send)
* "FILENAME" is either locked or missing.
Cannot open table file [FILENAME] (AddressTable:Read)
* The LANTMAIL.TAB is missing from your installation.
It is supposed to be located in the
\MHS\MAIL\GATES\"LANTMAIL"\PUBLIC\ subdirectory. Reinstall
FLASH-Gate(TM).
Cannot read message [FILENAME] (MHSToLANtastic)
* Invalid (non-MHS) message!
Cannot send file (Message:Send)
* The disk (that MHS resides on) is probably full.
Cannot send message. (Inpost:MHSNonDelivery)
* Cannot send delivery report for message with invalid address. The
disk (that MHS resides on) is probably full.
Cannot send message from [USERNAME] (Inpost:LANtasticToMHS)
* The disk (that MHS resides on) is probably full.
Cannot Set queue entry (LANtasticMail:Send)
* The gateway couldn't add the message to the queue. The LANtastic(R)
queue/spool area may be corrupt or the disk might be full.
Cannot set raw mode on mail device on Server [SERVER]
(LANtasticMail:Send)
* Something is wrong with the mail device. Try to send a binary
message manually from the MHS server/host username/login.
Cannot write. (LANtasticMail:Send)
* Cannot write to the LANtastic(R) mail device. The disk (that the
LANtastic(R) queue/spool area resides on) is probably full.
Cannot write attachment (Message:Send)
* The disk (that MHS resides on) is probably full.
Cannot write to mail device on Server [SERVER] (LANtasticMail:Send)
* The disk (that the LANtastic(R) queue/spool area resides on) is
probably full.
Invalid signature (Message:Read)
FLASH-Gate(TM). Copyright (C) 1993 Frango KB Page 13
* The file/message has an invalid MHS signature and is probably not
an MHS message.
Invalid (too long) signature (Message:SetSignature)
* The file/message has an invalid MHS signature and is probably not
an MHS message.
License file missing or damaged
* The FLASH-Gate(TM) license file cannot be found or is damaged.
Reinstall FLASH-Gate(TM).
Send-to missing in message [FILENAME] (MHSToLANtastic)
* The message does not have the "Send-to:" field and is invalid.
Sender missing in message. (Inpost:MHSNonDelivery)
* The message does not have the "Sender:" field and is invalid.
Signature missing (Message:Read)
* The file/message does not have an MHS signature and is probably not
an MHS message.
Trial package license has expired (TRIAL VERSION ONLY).
* The trial period of your program is over. Contact NICK Systems for
a retail package.